home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 / Ham Radio 2000.iso / ham2000 / bbs / rtmail11 / retmail.doc < prev    next >
Text File  |  1995-08-12  |  4KB  |  115 lines
  1.  
  2.                                 RETMAIL v1.1
  3.          A util for F6FBB BBSes which returns undelivered messages.
  4.                      (c) 1995 Mathijs Maassen (PE1NTP)
  5.  
  6. As of version 5.15 of the FBB BBS the EPURMESS program returns messages
  7. which cannot be forwarded due to a bad or unknown route. (Or sysop laziness
  8. :-) Local messages however are simply killed after expiring, without
  9. notifying the sender of the message. I wrote RETMAIL to fix this problem.
  10.  
  11. RETMAIL returns two types of messages:
  12.   o Messages for known users which are about to expire.
  13.   o Messages for unknown users which are about to expire.
  14.  
  15. The expiry of unread pmail is handled by RETMAIL itself, not by EPURMESS.
  16.  
  17. RETMAIL scans the message database (DIRMES.SYS) for messages with type 'P',
  18. status 'N' and no @BBS field. (i.e. local unread p-mail) It then checks
  19. if the callsign for whom the message is has an entry in the users database.
  20. (INF.SYS). If the message is expired it will be returned to the originator,
  21. and the message-status will be changed to 'K'. (i.e. killed)
  22.  
  23. The locations of the various files are taken from INIT.SRV. RETMAIL should
  24. be started from the directory where the INIT.SRV file resides.
  25.  
  26. The two expiry limits are given as command-line arguments to RETMAIL. The
  27. first argument is the number of days after which a message for an unknown
  28. user will expire. The second argument is the number of days for message to a
  29. known user. For example:
  30.  
  31. RETMAIL 7 100
  32.  
  33. This will return messages for unknown users after 7 days, and unread
  34. messages for known users after 100 days.
  35.  
  36. If RETMAIL is given a third argument it will operate in debug mode. It
  37. doesn't matter what the third argument is. In debug mode no messages are
  38. killed, and the output is written to the file RETMAIL.DBG instead of the
  39. MAIL.IN file. I recommend testing RETMAIL in debug mode before using it in
  40. Real Life Situations (tm).
  41.  
  42. RETMAIL should be started from within your APPEL.BAT (or whatever name it
  43. has on your system). Don't use RETMAIL while the BBS is running! It's safe
  44. to run it in debug mode though.
  45.  
  46. Returned messages look like this:
  47.  
  48. #
  49. SP PE1XYZ @ PI8ABC
  50. Returned mail: Message expired
  51. Your message for PE1HPV entitled 'Re: tmail'
  52. was about to expire after being unread for 50 days.
  53. PE1HPV's last login was on Mon 12 Jun 1995, 02:42:00 GMT
  54. -----------------------------------------------------------------------------
  55. Path: !PI8XYZ!PI8ABC!
  56.  
  57. --message--
  58.  
  59. ./EX
  60. #
  61. SP PA3XYZ
  62. Returned mail: User unknown
  63. Your message for PA0AAA entitled 'Example'
  64. cannot be delivered: User is not known at this BBS.
  65. -----------------------------------------------------------------------------
  66.  
  67. --message--
  68.  
  69. ./EX
  70.  
  71.  
  72. How to install RETMAIL on your system
  73. -------------------------------------
  74.  
  75. o Copy RETMAIL.EXE to a directory which is in your DOS path (e.g. \FBB\BIN)
  76.  
  77. o Run RETMAIL in debug mode to check if it works OK. For example:
  78.  
  79.   RETMAIL 7 100 x
  80.  
  81.   Check the file RETMAIL.DBG. If it's empty no messages were returned.
  82.   Try a lower expiry limit instead. (Just for testing purposes)
  83.  
  84. o Add RETMAIL to APPEL.BAT, *before* EPURMESS. For example:
  85.  
  86.   CD \FBB
  87.   RETMAIL 7 100
  88.   EPURMESS
  89.  
  90. o Change EPURMESS.INI so that EPURMESS' expiry limit for unread pmail is
  91.   larger than the limit of RETMAIL. For example:
  92.  
  93.   ...
  94.   # PARAMETERS FOR PERSONAL MESSAGES:
  95.   #
  96.   # PN -> PX (days after message is written)
  97.   110
  98.   ...
  99.  
  100.  
  101.  
  102.  
  103. This version was written for FBB 5.15c. I can't guarantee that it will work
  104. with other versions. If 5.16 is released, and the format of DIRMES.SYS or
  105. INF.SYS is changed I will release another version of RETMAIL. (If it's still
  106. necessary. This task *should* be done by EPURMESS)
  107.  
  108.  
  109. If you have any questions or suggestions feel free to mail me.
  110.  
  111. Regards, Mathijs
  112.  
  113. Packet: PE1NTP @ PI8DAZ.#TWE.NLD.EU
  114. Internet: tyz@xs4all.nl
  115.